Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Directly Manipulating a Shape's Geometry

GXUnlockShape

You can use the GXUnlockShape function to allow QuickDraw GX to relocate, compress, or unload a shape that has been locked.

void GXUnlockShape(gxShape target);

target

A reference to the shape to unlock.

DESCRIPTION

The GXUnlockShape function releases a previously locked shape for relocation or
other movement.

To directly edit a shape's geometry, call GXLockShape followed by GXGetShapeStructure. After editing, call GXUnlockShape followed
by GXChangedShape. Once you call GXUnlockShape, the shape's geometry
may be relocated and a pointer returned by GXGetShapeStructure may no
longer be valid.

SPECIAL CONSIDERATIONS

To avoid fragmenting the QuickDraw GX heap, call the GXUnlockShape function as soon as possible after calling GXLockShape.

ERRORS, WARNINGS, AND NOTICES

Errors
shape_is_nil
Notices (debugging version)
shape_not_locked

SEE ALSO

The GXLockShape function is described in the previous section. The GXGetShapeStructure and GXChangedShape functions are described in the following two sections.

The GXDisposeShape function is described on page 2-55.